Skip to content

chore: release v3.5.0#639

Closed
carlos-alm wants to merge 1 commit intomainfrom
release/3.5.0
Closed

chore: release v3.5.0#639
carlos-alm wants to merge 1 commit intomainfrom
release/3.5.0

Conversation

@carlos-alm
Copy link
Copy Markdown
Contributor

Summary

  • Bump version to 3.5.0
  • Add CHANGELOG entry for all 23 commits since v3.4.0
  • Update ROADMAP Phase 6.8 with incremental rebuild progress (roles 255ms → 9ms)
  • Restore missing libc fields in package-lock.json Linux entries

Test plan

  • npm install succeeds with updated lock file
  • CHANGELOG renders correctly on GitHub
  • ROADMAP checklist items match actual codebase state

@claude
Copy link
Copy Markdown

claude bot commented Mar 26, 2026

Claude finished @carlos-alm's task —— View job


Code Review Complete

Reviewing release v3.5.0 PR following strict review criteria:

Todo List

  • Phase 1: Root Cause Analysis
  • Phase 2: Configuration Change Detection
  • Phase 3: Test Integrity Check
  • Phase 4: Code Quality Review
  • Phase 5: Backlog Compliance Assessment
  • Final Recommendation

Root Cause Analysis

Problem Being Solved: Standard v3.5.0 release with changelog and version bump
Why This Approach: Automated release pipeline via commit-and-tag-version
Risk Assessment: Medium risk due to critical version sync failure

Backlog Compliance

  • Zero-dep: ✓ — No new runtime dependencies added
  • Foundation-aligned: ✓ — Standard release mechanics, no principle violations
  • Problem-fit: 3 — Release maintenance, doesn't directly solve core AI agent problems
  • Breaking: No — Purely additive version bump
  • Tier: 1

Critical Concerns

🚨 BLOCKING ISSUE: Native engine version mismatch

package.json:84-89 shows all native binary packages still at 3.4.0 while main package is 3.5.0:

"@optave/codegraph-darwin-arm64": "3.4.0",
"@optave/codegraph-darwin-x64": "3.4.0", 
"@optave/codegraph-linux-arm64-gnu": "3.4.0",
"@optave/codegraph-linux-x64-gnu": "3.4.0",
"@optave/codegraph-linux-x64-musl": "3.4.0", 
"@optave/codegraph-win32-x64-msvc": "3.4.0"

Impact: This breaks native engine functionality on v3.5.0. Users will get WASM fallback instead of native performance, defeating the purpose of the dual-engine architecture.

Root cause: The scripts/sync-native-versions.ts script should have run during npm version but apparently failed to update optionalDependencies.

Minor documentation inconsistencies:

  • PR description mentions "Phase 6.8" but ROADMAP.md has no Phase 6.8
  • CHANGELOG mentions "255ms → 9ms" improvement but this specific metric not found in current roadmap

Final Recommendation

  • Rating: ⭐⭐☆☆☆ (2/5)
  • Action: REQUEST CHANGES
  • Reasoning: The native binary version mismatch is a critical functional regression that will break native engine performance for all v3.5.0 users. This must be fixed before release.

Required fixes:

  1. Run npm run version script manually or update optionalDependencies to 3.5.0
  2. Fix "Phase 6.8" reference in PR description
  3. Consider adding version sync validation to release CI

@greptile-apps
Copy link
Copy Markdown
Contributor

greptile-apps bot commented Mar 26, 2026

Greptile Summary

This is a standard release PR that bumps the project to v3.5.0 across all three version manifests (package.json, package-lock.json, crates/codegraph-core/Cargo.toml) and documents the 16-entry changelog for this release cycle. The ROADMAP Phase 6.8 section is updated to reflect shipped work (roles 96% speedup, compound DB indexes) with remaining items preserved. No source code is changed.

Key observations:

  • All three version strings (package.json, package-lock.json, Cargo.toml) are consistently bumped from 3.4.0 → 3.5.0 ✅
  • CHANGELOG entry covers all merged PRs from this cycle with accurate PR links and descriptions ✅
  • ROADMAP Phase 6.8 status correctly transitions from "Not started" to "In progress" with shipped items marked ✅
  • PR description bullet "Restore missing libc fields in package-lock.json Linux entries" is not reflected in the actual diff — the base and head commits contain identical libc occurrences in package-lock.json (see comment)

Confidence Score: 5/5

Safe to merge — all version strings are consistent, no source code is modified, and the only issue is a description inaccuracy that does not affect release correctness.

The entire diff is documentation and version-string changes. All three version manifests agree on 3.5.0, the CHANGELOG accurately records merged PRs, and the ROADMAP update reflects shipped work. The single noteworthy finding (the libc bullet in the PR description) is a description discrepancy with no impact on the release artifact itself.

No files require special attention; the only flag is a stale bullet in the PR description, not in any changed file.

Important Files Changed

Filename Overview
package.json Version bumped from 3.4.0 to 3.5.0 — single line change, correct.
package-lock.json Version bumped from 3.4.0 to 3.5.0 in both the root and packages[""] entries; no other changes present.
crates/codegraph-core/Cargo.toml Cargo crate version bumped from 3.4.0 to 3.5.0, consistent with the Node package version.
CHANGELOG.md New v3.5.0 section added with 16 entries (1 feature, 9 bug fixes, 2 perf, 4 refactors); PR description claims 23 commits but the count difference is expected (commits ≠ changelog entries).
docs/roadmap/ROADMAP.md Phase 6.8 updated from "Not started" to "In progress" with ✅ markers for shipped items and 🔲 for remaining work; version header updated to 3.5.0.
docs/roadmap/BACKLOG.md Trivial date update from 2026-03-25 to 2026-03-26.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[chore: release v3.5.0] --> B[package.json\n3.4.0 → 3.5.0]
    A --> C[package-lock.json\n3.4.0 → 3.5.0]
    A --> D[Cargo.toml\n3.4.0 → 3.5.0]
    A --> E[CHANGELOG.md\nAdd v3.5.0 section]
    A --> F[ROADMAP.md\nPhase 6.8: Not started → In progress]
    A --> G[BACKLOG.md\nDate: 2026-03-25 → 2026-03-26]

    E --> E1[1 Feature\nTitan pipeline run]
    E --> E2[9 Bug Fixes\nfindCaller, JSONC, WASM, dogfood...]
    E --> E3[2 Perf\nRoles 255ms→9ms, DB indexes]
    E --> E4[4 Refactors\nerrors, constants, SLOC, cfg-visitor]

    F --> F1[✅ Roles batch UPDATE\n−96% latency]
    F --> F2[✅ Compound DB indexes\nquery regression fixed]
    F --> F3[🔲 Skip unchanged phases]
    F --> F4[🔲 Incremental edge rebuild]
    F --> F5[🔲 Sub-100ms target]
Loading

Reviews (1): Last reviewed commit: "chore: release v3.5.0" | Re-trigger Greptile

Comment on lines 1 to 12
{
"name": "@optave/codegraph",
"version": "3.4.0",
"version": "3.5.0",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "@optave/codegraph",
"version": "3.4.0",
"version": "3.5.0",
"license": "Apache-2.0",
"dependencies": {
"better-sqlite3": "^12.6.2",
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 PR description references a change not present in the diff

The PR description includes the bullet point "Restore missing libc fields in package-lock.json Linux entries," but the actual package-lock.json diff contains only the two version-string changes (3.4.03.5.0). A grep on both the base and head commits confirms the same 10 libc occurrences exist in both — no libc lines were added or restored in this PR.

This looks like either:

  • the libc restoration was already on main before this branch was created (e.g., landed in an earlier hotfix), or
  • it was listed in the description but was not actually included.

Either way, the description bullet and the corresponding test-plan item (npm install succeeds with updated lock file) may mislead reviewers. Consider removing or correcting this bullet if the change is already upstream.

@carlos-alm
Copy link
Copy Markdown
Contributor Author

Closing — version corrected to v3.4.1 (patch, not minor). The Titan pipeline commit is internal tooling, not a user-facing feature. Replaced by new PR on release/3.4.1.

@carlos-alm carlos-alm closed this Mar 26, 2026
@github-actions github-actions bot locked and limited conversation to collaborators Mar 26, 2026
@carlos-alm carlos-alm deleted the release/3.5.0 branch March 26, 2026 23:26
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant